home *** CD-ROM | disk | FTP | other *** search
/ Workbench Designer 2 / Workbench Designer 2.iso / workbench-tools / amigaeye / amigaeye.dok < prev    next >
Encoding:
Text File  |  1997-06-28  |  18.9 KB  |  325 lines

  1.                                              _   _
  2.                                             / \ / \
  3.                                             \#/ \#/
  4.            _              _                    _      _             _
  5.           /(\  Version:  /(\     _            /(\    /(\           /(\
  6.          /  \    37.5   /  \    /(\          /  \   /  \          /  \
  7.         /    \   39.5  /    \  /  \         /    \ /    \___     /    \
  8.        /      \       /      \/    \       /     //     ___ \   /      \
  9.       /        \     /              \     /     //     /\__\ \ /        \
  10.      /          \   /                \   /     //     / /   )//          \
  11.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  12.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  13.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  14.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \___\     \
  15.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  16.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  17.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  18.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  19.                                                            _______  ___ _____
  20.       Christian Krapp       krabbe@rz.fh-augsburg.de      / __//\ \/ /// __//
  21.       Hagenmähderstr.9                                   / _//   \  /// _//
  22.     D-86391 Stadtbergen                                 / //__   / /// //__
  23.       (GERMANY)                                         \___//  /_// \___//
  24.                                              © 1995,1996,1997 by Christian Krapp
  25.                                                   Freigegeben als SHAREWARE
  26.  http://www.fh-augsburg.de/~krabbe/amigaeye/
  27.  
  28.              An AugustA team Release!
  29. --------------------------------------------------------------------------------
  30.  
  31. Copyright:
  32.   Dieses Programm  und alle dazugehörige Dateien (Programm-Icon) sind  Copyright
  33. 1995-97 bei Christian 'cr8y' Krapp! Es darf nur im unveränderten Zustand weiter-
  34. gegeben  werden.  Eine Gebühr, die über den üblichen  Disketten-Preis  zuzüglich
  35. einer geringen Kopiergebühr liegt, darf nicht  erhoben werden.  Desweiteren darf
  36. dieses Programm nicht ohne Genehmigung auf eine PD-Serie oder eine  CD-Rom über-
  37. nommen werden. Diese Genehmigung ist beim Autor erhältlich und wird in der Regel
  38. gegeben.
  39.  
  40.   Nur  für die  AmiNet, FreshFish, und  MeetingPearls  CD-Rom-Serien  sind keine
  41. Genehmigungen nötig.
  42.  
  43.   Dieses  Programm  ist  als  Shareware  freigegeben. Jeder  der dieses Programm
  44. benutzt sollte sich registrieren lassen (mehr dazu weiter unten). Die Shareware-
  45. gebühr beträgt 5,- DM zzgl. Versand!
  46.  
  47.   Für Schäden, dir durch  die Benutzung  dieses  Programmes  entstehen, kann der
  48. Autor nicht haftbar gemacht werden. 
  49.  
  50. --------------------------------------------------------------------------------
  51.  
  52. Einführung:
  53.   Jeder Amiga-Benutzer  dürfte die verschiedenen Gag-Programme kennen,  die  ein
  54. Augenpaar auf dem Bildschirm anzeigen, das dem Mauszeiger "verfolgt". Doch eines
  55. hat mich schon immer  gestört: Diese Augen passen nicht ganz zum Rest einer auf-
  56. gepeppten Workbench, da die meisten dieser Augenprogramme mit SW-Augen arbeiten.
  57. Aus diesem  Grund  hab ich mir  die "Arbeit" gemacht  und ein farbiges Augenpaar
  58. erstellt.
  59.   Angefangen hat dies  bereits 1995 und ergab  MagicEYE. Inzwischen sind schon 2
  60. Jahre  vergangen und deshalb hat sich auch  einiges geändert (nicht nur der Name
  61. und die Einführung der Sharewargebühr). Deshalb dürfte es sich für jeden lohnen,
  62. das geschichtliche durchzulesen ;-)
  63.  
  64. --------------------------------------------------------------------------------
  65.  
  66. 10 Gründe, dieses Programm zu benutzen:
  67.  
  68.  1.) Die Augen sind Bunt ;^)
  69.  2.) Fenster wird geschlossen, wenn WB geschlossen wird (screennotify.library)
  70.  3.) Viele Parameter sind einstellbar
  71.  4.) Patch, damit sich das Augen-Fenster wie die Screentitelleiste verhält
  72.  5.) 10(!) verschiedene Effekte mit den Augen
  73.  6.) Paßt sich an Farbpalette an MagicWB wird nicht mehr benötigt (AmigaOS 3.0+)
  74.  7.) Sehr kurzes Programm
  75.  8.) Es ist ein Commodity
  76.  9.) Bildschirm-Hintergrund kann in AmigaEYE-Fenster kopiert werden
  77. 10.) AmigaEYE-Fenster ist immer das hinterste Fenster
  78.  
  79. --------------------------------------------------------------------------------
  80.  
  81. Was wird benötigt?
  82.   Auf jeden  Fall braucht  man einen  Amiga-Computer  (oder kompatibel ;^) ) mit
  83. mindestens AmigaOS  2.04 oder höher. Leider  kann ich nicht garantieren, daß die
  84. Programmversion  für AmigaOS 2.04  funktioniert, da  ich nur  einen  Rechner mit
  85. AmigaOS 3.0  besitze. Desweiteren sollte  die Workbench mit mindestens  8 Farben
  86. und einer  möglichst quadratischen-Auflösung  (z.B. 640×512)  betrieben  werden.
  87. Auch  sollte  möglichst  für  die   Bildschirmtitelleiste  ein  Zeichensatz  mit
  88. mindestens der  Größe 13 benutzt werden,  da ansonsten die Augen über die Titel-
  89. leiste  hinausstehen. Um das Fenster  beim schliessen der WB  auch zu schließen,
  90. wird noch die  ScreenNotify-Library von Stefan  Becker benötigt. Ist diese nicht
  91. installiert, wird das Fenster nicht geschlossen.
  92.  
  93. --------------------------------------------------------------------------------
  94.  
  95. Die verschiedenen Programm-Versionen:
  96.   Es ist eigentlich sehr einfach: Da  AmigaOS 3.0  einige bessere Funktionen hat
  97. und es  ermöglicht, die  Farben  auf der Workbench zu reservieren, habe ich mich
  98. entschlossen, zwei Versionen  von  AmigaEYE  zu erstellen. Eine  für AmigaOS 2.0
  99. (AmigaEYE_37) und eine für AmigaOS 3.0 (AmigaEYE_39) und höher.
  100.  
  101. --------------------------------------------------------------------------------
  102.  
  103. Wie wird dieses Programm installiert?
  104.   Es  gibt  fast nichts einfacheres als das:  Man muß nur die richtige Programm-
  105. Version in das WBStartup-Verzeichnis der Startdiskette/-festplatte kopieren. Das
  106. wars :-]
  107.   Wer die Programme lieber in der User-Startup startet, kopiert die richtige
  108. Programm-Version am besten in sein C-Verzeichnis und ruft AmigaEYE in der
  109. User-Startup mit den entsprechenden Parametern auf.
  110.  
  111. --------------------------------------------------------------------------------
  112.  
  113. Verwendung:
  114.   Dieses Programm kann von der Workbench (bzw. WBStartup-Verzeichnis) oder einer
  115. Shell (User-Startup) aus  gestartet werden. Desweiteren  fehlt dem Programm eine
  116. grafische  Oberfäche. D.h. alle Parameter müssen dem  Programm mittels ToolTypes
  117. im Icon bzw. als Parameter übergeben werden. Folgende Parameter sind möglich:
  118. vorhanden:
  119.  
  120.   DONOTWAIT       : Dies ist  eigentlich kein  Parameter  für AmigaEYE,  sondern
  121.                     viel mehr ein  Schalter  für die  Workbench.  Dieser Eintrag
  122.                     sollte nicht entfernt werden!
  123.   WIN_X           : Mit diesen beiden Parametern wird die Position der Augen auf
  124.   WIN_Y             dem Bildschirm  festgelegt. Dabei wird von der oberen linken
  125.                     Ecke aus positioniert! Die voreingestellten Werte sind:
  126.                     WIN_X=545  und WIN_Y=1
  127.                     ACHTUNG: Wenn  ein kleiner  Zeichensatz als Titelleistenfont
  128.                     eingestellt  ist (mindestens  11  Punkte), dann  sollte  man
  129.                     WIN_Y auf 0 setzen!
  130.   PRIORITY        : Gibt die Taskpriorität für das System an. Dieser Wert sollte
  131.                     möglichst  unter 0 liegen, damit  Programm,  die  Rechenzeit
  132.                     benötigen diese auch  erhalten. Im  Programm voreingestellte
  133.                     ist der Wert 0, im Icon ist -5 voreingestellt.
  134.   MOVEABLE        : Fenster kann auf dem Bildschrim verschoben werden.
  135.   DRAGPATCH       : Mit diesem (NICHT(!)  systemkonformen) Patch ist es möglich,
  136.                     daß man auch mit dem Augen-Fenster den Bildschirm nach unten
  137.                     bzw. zur Seite verschieben kann. Wird dieses Flag angegeben,
  138.                     so ist der  Patch aktiv,  ansonsten wird  dieser Patch nicht
  139.                     durchgeführt.
  140.   BACKGROUND      : Kopiert den Hintergrund der an der  Position ist, an der die
  141.                     Augen erscheinen sollen, in das AmigaEYE-Fenster.
  142.   QUICKQUIT       : Schnelles Beenden  von AmigaEYE  (mit der rechten Maustaste)
  143.                     ermöglichen.
  144.   BACKDROP        : Mit diesem  Schalter wird der Layer-Patch aktiviert, der das
  145.                     AmigaEYE  Fenster  immer  hinter  alle  andere Fenster legt.
  146.                     ACHTUNG: Es wird die  layer.library's Funktion  BehindeLayer
  147.                     (-54) verändert!
  148.   SLEEP_PERIOD    : Dieser Parameter gibt an, wie lange es dauert, bis die Augen
  149.                     geschlossen  werden, wenn  die  Maus nicht mehr bewegt wird.
  150.                     Voreingestellt ist ein Wert von 5. (in Sekunden)
  151.   LIDCOLOR1       : Mit diesen ToolTypes können die verschiedenen Farben gesetzt
  152.   LIDCOLOR2         werden. Dazu muß nach dem Schlüsselwort eine Hexadezimalzahl
  153.   BLOODCOLOR        angegeben werden, die wiefolgt aufgebaut ist:
  154.   PUPILCOLOR1                                 RRGGBB
  155.   PUPILCOLOR2          RR - Rotanteil  (von 00 bis FF)
  156.   PUPILCOLOR3          GG - Grünanteil (von 00 bis FF)
  157.   EYECOLOR1            BB - Blauanteil (von 00 bis FF)
  158.   EYECOLOR2         Damit ergibt FFFFFF die Farbe weiß!
  159.   PUPILREDCOLOR1    ACHTUNG: Wenn die  Farbänderungen nicht funktionieren,  dann
  160.   PUPILREDCOLOR2             kann es  daran liegen,  daß keine  Farbregister auf
  161.   PUPILREDCOLOR3             dem Screen mehr frei sind.
  162.  
  163. Und nun zu den 'etwas' interessanteren Effekte-Parametern. Dabei ist anzumerken,
  164. daß die angegebenen Werte die  Wahrscheinlichkeit des  Eintretens dieser Effekte
  165. angibt (1/wert). Es sind  nur Werte größer  als 1 erlaubt. Wird als Wert 0 über-
  166. geben, so wird der Effekt ausgeschaltet!
  167.  
  168.   SLEEPY            : Mit diesem Parameter kann man bestimmen, wie oft die Augen
  169.                       blinzeln  sollen.
  170.   TIRED             : Dieser  Parameter  bestimmt, wie oft  die Augenlider  halb
  171.                       herunter klappen.
  172.   ROLL_SYNCHRON     : Bestimmt wie Wahrscheinlichkeit das die Pupillen der Augen
  173.                       (synchron, d.h. gleiche Richtung) rollen.
  174.   ROLL_ASYNCHRON    : Bestimmt die Wahrscheinlichkeit das die Pupillen der Augen
  175.                       (asynchron, d.h. entgegengesetzte Richtung) rollen.
  176.   LEFTRIGHT         : Wie oft sollen die Augen Links-Rechts schauen?
  177.   UPDOWN            : Wie oft sollen die Augen Oben-Unten schauen?
  178.   RANDOM_EYE        : Gibt an, wie oft die Augen zittern.
  179.   BLOODY            : Bestimmt, wann die Augen rot unterlaufen.
  180.   CLEAR             : Wann sollen rotunterlaufene Augen wieder hell werden.
  181.   LEFT_EYE          : Schließt kurz linkes Auge. (Abhängig von SLEEPY)
  182.   RIGHT_EYE         : Schließt kurz rechtes Auge. (Abhängig von SLEEPY)
  183.   ANGRY             : Böse Augenlider. (Abhängig von SLEEPY)
  184.   ANXIOUS           : Ängstliche Augenlider. (Abhängig von SLEEPY)
  185.   INSULT            : Beleidigte Augen, Pupillen schauen  in die andere Richtung
  186.   STOP_TIRED        : Wann wird TIRED Effekt beenden.
  187.   STOP_ANGRYANXIOUS : Wann sollen die böse bzw. ängstliche  Augen beendet werden
  188.   STOP_EFFEKT       : Wann wird ein  Effekt beendet. Wenn hier 0 angegeben wird,
  189.                       so läuft der Effekt endlos.
  190.   PUPILNORMAL       : Wann soll normale Pupille angezeigt werden.
  191.   PUPILBIG          : Wann soll große Pupille angezeigt werden.
  192.   PUPILCROSS        : Wann soll Kreuz Pupille angezeigt werden.
  193.   PUPILAMIGA        : Wann soll Amiga Pupille angezeigt werden.
  194.   PUPILHEART        : Wann soll Herz Pupille angezeigt werden.
  195.  
  196.   So, daß wäre  eigentlich alles, was man zu diesem Tool wissen müsste. Oder...?
  197. Ach, ich hab noch nicht erzählt, wie man das Programm  beendet? Nun,  eigentlich
  198. meine  ich,  daß dieses Programm auf jede 8 Farben Workbench  gehört. Wenn  aber
  199. jemand dieses Programm  beenden will, dann kann er dies wiefolgt machen (es gibt
  200. drei Möglichkeiten):
  201. 1.) AmigaEYE einfach nochmal starten!
  202. 2.) Exchange starten, AmigaEYE aus der Liste auswählen und "Entfernen" anwählen!
  203. 3.) (mit QUICKQUIT) AmigaEYE Fenster aktivieren und die rechte Maustaste drücken
  204.  
  205. --------------------------------------------------------------------------------
  206.  
  207. Was kann man an dem Programm noch verbessern?
  208.   * Man kann noch ein paar Spielereien  mit den Augen machen.
  209.   * Man kann noch Augenbrauen einfügen
  210.   * Man kann davon  ausgehen,  das  noch  irgendwelche  Fehler  (undokumentierte
  211.     Möglichkeiten oder gar Käfer ;^) ) enthalten sind, die man entfernen sollte.
  212.  
  213. --------------------------------------------------------------------------------
  214.  
  215. ACHTUNG:  AmigaEYE  wird  durch  ADSG  vertrieben!  Um AmigaEYE registrieren  zu
  216. lassen, benutzen  Sie bitte  das entsprechende  ADSGFormular (siehe extra Datei)
  217. Weiters auch unter http://www.amigaworld.com/adsg/
  218.  
  219. Wer AmigaEYE  registrieren will,  Verbesserungsvorschläge,  Fehler usw. hat, der
  220. kann/sollte sich an folgende Adresse wenden:
  221.  
  222.                  sMail:           Christian Krapp
  223.                                   Hagenmähderstr. 9
  224.                                 D-86391 Stadtbergen
  225.                                   (GERMANY)
  226.                  eMail:           krabbe@rz.fh-augsburg.de
  227.  
  228.        Sharewaregebühr:           5,- DM
  229.  
  230. --------------------------------------------------------------------------------
  231.  
  232. Geschichtliches: (xx steht entweder für 37 (AmigaOS 2.04) bzw. 39 (AmigaOS 3.0))
  233.         __       __
  234.         )\\     /((                                          __
  235.        /  \\   /  \\               __         ________      / \\     ________
  236.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  237.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  238.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  239.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  240.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  241.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  242. / // © 1995--1997 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  243. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  244.       sMail:                                               ________ ___ _____
  245.   Christian Krapp                 eMail:                  / __//\ \V /// __//
  246.   Hagenmähderstr.9    krabbe@informatik.fh-augsburg.de   / _//   \  /// _//
  247. D-86391 Stadtbergen                                     / //__   / /// //__
  248.   (GERMANY)                        WWW:                 \___//  /_// \___//
  249.                 http://www.fh-augsburg.de/~krabbe/magiceye/
  250.  
  251. Vxx.0   28.04.1995 - Die ersten Arbeiten an dem Programm beginnen (Animationen).
  252. Vxx.1   16.06.1995 - Nach langer Arbeit (und erneutem erstellen der Animationen)
  253.                      ist die erste brauchbare Version fertig.
  254. Vxx.2   01.08.1995 - Ein etwas komischer  Fehler wurde behoben  (Danke an Roland
  255.                      Fulde).
  256.                    - Farbanpassung  implementiert  (Nachdem sich Markus Speicher
  257.                      und Mario  Cattaneo  als  einzige dafür interessiert haben,
  258.                      nur 39.x-Version).
  259.                    - ScreenNotify-Library   wird  unterstützt  (Idee  von  Mario
  260.                      Cattaneo).
  261.                    - Augenrollen (Idee von Dirk Wrocklage).
  262.                    - Zitternde  und rot  unterlaufene  Augen (Idee  von  Michael
  263.                      Krapp).
  264.                    - Augenrollen Asynchron, müde  Augen und Links-Rechts schauen
  265.                      (Idee von Christian Krapp)
  266. Vxx.3   01.03.1996 - ScreenNotify-Library ist nun optional!
  267.                    - Commodity-Library wird vollständig unterstützt!
  268.                    - Jetzt aus Shell oder User-Startup aus startbar.
  269.                    - Rot unterlaufene Augen werden wieder weiß (wenn Augen lang-
  270.                      genug geschlossen).
  271.                    - MagicEYE  hat jetzt  ein besseres  Zeitverhalten. Die alten
  272.                      Versionen liefen nicht korrekt mit Nemac IV (hoher Zeitver-
  273.                      brauch).
  274. Vxx.4   20.02.1997 - Hintergrund kann nun durchscheinend sein (option)!
  275.                    - Quickquit ist wieder als option drinnen!
  276.                    - MagicEYE-Fenster ist immer das hinterste Fenster
  277.                    - MagicEYE im WWW http://www.fh-augsburg.de/~krabbe/magiceye/
  278.                                              _   _
  279.                                             / \ / \
  280.                                             \#/ \#/
  281.            _              _                    _      _             _
  282.           /(\         :  /(\     _            /(\    /(\           /(\
  283.          /  \           /  \    /(\          /  \   /  \          /  \
  284.         /    \         /    \  /  \         /    \ /    \___     /    \
  285.        /      \       /      \/    \       /     //     ___ \   /      \
  286.       /        \     /              \     /     //     /\__\ \ /        \
  287.      /          \   /                \   /     //     / /   )//          \
  288.     /     /\     \ /     /\    /\     \ /     //     / /    \/     /\     \
  289.    /     /__\    //     / /\  / /\    //     //     / /______\    /__\     \
  290.   /     ____    //     / /  \/ / /   //     //     / / _     \\    ____     \
  291.  /     /\__/   //     / /    \/ /   //     / \    ( /\( \    /\\   \_  \     \
  292.  \    ( / (___/ \    ( /       (___/ \    ( / \    V  \\/   / / \___)\  )    /\
  293.   \    V   \__\/ \    V         \__\/ \    V   \    \__7   / /   \__\/ /    / /
  294.    \___/\         \___/\               \___/\   \_________/ /          \___/ /
  295.     \__\/  sMail:  \__\/     eMail:     \__\/    \________\/            \__\/
  296.                                                            _______  ___ _____
  297.       Christian Krapp       krabbe@                       / __//\ \/ /// __//
  298.       Hagenmähderstr.9      informatik.fh-augsburg.de    / _//   \  /// _//
  299.     D-86391 Stadtbergen                                 / //__   / /// //__
  300.       (GERMANY)                                         \___//  /_// \___//
  301.                                              © 1995,1996,1997 by Christian Krapp
  302.                                                   Freigegeben als SHAREWARE
  303.  
  304. Vxx.5  01.07.1997  - Fehler in Layer-Patch entfernt
  305.                    - Besseres Zeitverhalten!
  306.                    - Es  kann jetzt die Farbe  der Augelider,  blutunterlaufenen
  307.                      Augen, Pupillen und Augäpfel geändert werden.
  308.                    - Neue Effekte:
  309.                      + Augenlider können einzeln schließen,
  310.                      + ärgerliche, ängstliche und beleidigte Augen,
  311.                      + Augen schauen nach oben-unten.
  312.                      + verschiedene Pupillen-Graphiken:
  313.                        * Normal
  314.                        * Große Pupillen
  315.                        * Kreuz Pupillen
  316.                        * Amiga Pupillen
  317.                        * Herz Puplllen
  318.                    - Effekte können ausgeschaltet werden.
  319.                    - Fenster kann verschoben werden
  320.                    - Einige benötigte ToolTypes wurden implementiert.
  321.                    - Konfigurations-Datei wurde zusätzlich eingeführt.
  322.                    - Einige Fehler wurden entfernt.
  323.  
  324. --------------------------------------------------------------------------------
  325.